home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / UTILITY / FB100.ARJ / FBUDDY.DOC next >
Text File  |  1992-05-30  |  52KB  |  1,233 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                   F i l e B U D D Y (tm)
  10.  
  11.  
  12.  
  13.                                More Than Just A File Viewer
  14.  
  15.                                        Version 1.00
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                        USER'S GUIDE
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.                               Copyright (c) 1992 Lenard Dean
  49.                                    All Rights Reserved
  50.  
  51.                                        May 30, 1992
  52.             Warranty And License
  53.             ====================
  54.  
  55.             This software and accompanying documentation is provided AS-IS.
  56.             Even though the author has tested this software and reviewed its
  57.             documentation, NO WARRANTY OR REPRESENTATION RELATING TO IT IS
  58.             MADE, WHETHER EXPRESSED OR IMPLIED, INCLUDING, WITHOUT
  59.             LIMITATION, THE WARRANTIES OF MERCHANTABILITY AND OF FITNESS FOR
  60.             ANY PURPOSE.  THE AUTHOR ASSUMES NO LIABILITY FOR DAMAGES, DIRECT
  61.             OR CONSEQUENTIAL, WHICH MAY RESULT FROM THE USE OF THIS SOFTWARE,
  62.             even if advised of the possibility of such damages.  THE USER
  63.             BEARS ALL RISK AS TO THE QUALITY AND PERFORMANCE OF THIS
  64.             SOFTWARE.  IN NO EVENT SHALL ANY DAMAGES EXCEED THE PRICE PAID
  65.             FOR THE LICENSE TO USE THIS SOFTWARE REGARDLESS OF THE FORM OF
  66.             CLAIM.
  67.  
  68.             You ARE encouraged to pass along copies of FileBUDDY to friends
  69.             and your favorite BBSs.  Please distribute ONLY the original
  70.             self-extracting file FB1O0.EXE you received.  Anyone that would
  71.             like to distribute FileBUDDY for remuneration must first contact
  72.             the author.  Vendors recognized by the ASP may offer FileBUDDY
  73.             immediately without any prior authorization from the author.
  74.  
  75.  
  76.             Ombudsman (ASP)
  77.             ===============
  78.  
  79.             This program is produced by           _______
  80.             a member of the Association      ____|__     |                (R)
  81.             of Shareware Professionals    --|       |    |-------------------
  82.             (ASP).  ASP wants to make       |   ____|__  |  Association of
  83.             sure that the shareware         |  |       |_|  Shareware
  84.             principle works for you.        |__|   o   |    Professionals
  85.             If you are unable to resolve  -----|   |   |---------------------
  86.             a shareware-related problem        |___|___|    MEMBER
  87.             with an ASP member by
  88.             contacting the member directly, ASP may be able to help.  The ASP
  89.             Ombudsman can help you resolve a dispute or problem with an ASP
  90.             member, but does not provide technical support for members'
  91.             products.  Please write to the ASP Ombudsman at 545 Grover Road,
  92.             Muskegon, MI 49442 or send a CompuServe message via CompuServe
  93.             Mail to ASP Ombudsman 70007,3536.
  94.  
  95.  
  96.             Trademarks
  97.             ==========
  98.  
  99.             Product names mentioned in this documentation are trademarks or
  100.             registered trademarks of their respective owners.  FileBUDDY is a
  101.             trademark of Lenard Dean.
  102.             Table Of Contents
  103.             =================
  104.  
  105.  
  106.  
  107.             Introduction ................................................. 1
  108.  
  109.  
  110.             Getting Started .............................................. 2
  111.  
  112.  
  113.             Using FileBUDDY .............................................. 3
  114.  
  115.  
  116.             Menus And Messages ........................................... 4
  117.  
  118.  
  119.             Editing A File ............................................... 5
  120.  
  121.  
  122.             Searching Text ............................................... 5
  123.  
  124.  
  125.             Capturing Text ............................................... 6
  126.  
  127.  
  128.             Extracting An Archive File ................................... 6
  129.  
  130.  
  131.             Configuring Your Printer ..................................... 6
  132.  
  133.  
  134.             Creating Printer Configurations .............................. 7
  135.  
  136.  
  137.             Viewing, Saving, And Printing Images ......................... 9
  138.  
  139.  
  140.             Customizing FileBUDDY ........................................ 11
  141.  
  142.  
  143.             Questions .................................................... 17
  144.  
  145.  
  146.             Appendix A: Registration ..................................... 18
  147.  
  148.  
  149.             Appendix B: Color Chart ...................................... 19
  150.             Introduction
  151.             ============
  152.  
  153.             FileBUDDY is a unique file viewer.  It combines 3 popular viewers
  154.             (text, archive, and image) into one program.  If you do a lot of
  155.             "BBSing", you will appreciate this.  Just as important is
  156.             FileBUDDY's simple user interface and straightforward program
  157.             layout which assures you FileBUDDY will not get in the way of
  158.             your viewing.  However, don't let its simpleness mislead you into
  159.             thinking FileBUDDY is not powerful.  Quite the contrary, as
  160.             the following summary shows:
  161.  
  162.                   * FileBUDDY can view ANY size file, whether the file
  163.                     is 1 byte or 1 gigabyte in length.
  164.  
  165.                   * FileBUDDY lets you capture text to a file by taking
  166.                     a "snapshot" of it.  When  a snapshot is taken, it
  167.                     is done "intelligently".  That is, overlapping text
  168.                     in consecutive snapshots will not be duplicated in
  169.                     the destination file.
  170.  
  171.                   * FileBUDDY incorporates a printer setup facility
  172.                     which allows you to configure ANY printer when
  173.                     printing text files.
  174.  
  175.                   * FileBUDDY views archive files.  If the proper
  176.                     archiver is available, files with the "ARC", "ARJ",
  177.                     "LZH", "PAK", or "ZIP" extensions can be viewed.
  178.                     Also, archived files being viewed may be edited or
  179.                     extracted.
  180.  
  181.                   * FileBUDDY displays image files.  If a VGA or a SVGA
  182.                     (with an ATI, Paradise, Trident, Tseng, Video 7
  183.                     chipset, or VESA compatible) video card is detected,
  184.                     BIF (binary), GIF, PCX, and TIF (uncompressed, LZW,
  185.                     or PackBits compression) image files can be viewed.
  186.                     Images too large for the video card to display are
  187.                     resized to fit the video card's best 256 color mode.
  188.                     If extended or expanded memory is available, it will
  189.                     be used to hold the image.  Any image can be resaved
  190.                     to another supported image format at a touch of a
  191.                     button.  Although Encapsulated PostScript (EPS) files
  192.                     cannot be viewed, images may be saved to that format.
  193.                     If a HP LaserJet or compatible laser printer is
  194.                     available, images may be printed out in 75, 100, 150,
  195.                     or 300 dpi with or without a user-defined border.
  196.                     Printing to file is also supported.
  197.  
  198.                   * FileBUDDY is completely customizable.  Full control
  199.                     over colors, borders, mouse sensitivity, and scroll
  200.                     speed is given to the user.  You can even specify
  201.                     your favorite text editor for FileBUDDY to use so that
  202.                     you can modify the file you are viewing.
  203.  
  204.  
  205.  
  206.                                                                             1
  207.             Getting Started
  208.             ===============
  209.  
  210.             To use FileBUDDY, you'll need the following minimum hardware:
  211.  
  212.                   - IBM PC, XT, AT, PS/2, or 100% compatible computer
  213.                   - 384K bytes of conventional memory
  214.                   - monochrome or color monitor
  215.                   - VGA video card (if you want to view image files)
  216.                   - a hard disk or floppy disk drive
  217.                   - mouse (optional)
  218.                   - printer (optional)
  219.  
  220.             You'll also need the software below:
  221.  
  222.                   - MS-DOS version 3.00 or later
  223.                   - text editor or wordprocessor that can save in ASCII
  224.  
  225.             The files supplied on your disk are:
  226.  
  227.                   FBUDDY.EXE    FileBUDDY program
  228.                   FBUDDYI.EXE   FileBUDDY image viewer program
  229.                   SAMPLE.INI    Sample initialization file
  230.                   INSTALL.EXE   Install program
  231.  
  232.             The quickest way to install FileBUDDY is to run INSTALL.  When
  233.             the install program is run, you will be asked about the
  234.             following:
  235.  
  236.                   1) the directory to install FileBUDDY in.  The default is 
  237.                      c:\fbuddy.
  238.  
  239.                   2) whether you want FileBUDDY's location added to the
  240.                      PATH statement in AUTOEXEC.BAT.  (If it already exists, 
  241.                      it will not be added.)  If so, the original AUTOEXEC.BAT
  242.                      will be saved as AUTOEXEC.OLD.
  243.  
  244.                   3) if you have a monochrome monitor with a color card.  
  245.                      If so, you should select this option to force a "black 
  246.                      and white" color setup.
  247.  
  248.             Check boxes are marked by clicking with the left mouse button.
  249.             To use the keyboard, select the TAB key to move between check
  250.             boxes and the SPACEBAR to mark them.  When you are ready to
  251.             install, press ENTER.
  252.  
  253.             To install FileBUDDY manually, copy all the files to the
  254.             destination directory.  Then from the destination directory type:
  255.  
  256.                   fbuddy
  257.  
  258.             If you're installing on a system with a monochrome display and
  259.  
  260.  
  261.  
  262.  
  263.                                                                             2
  264.             color card, use the "/bw" switch to force a "black and white"
  265.             color setup as follows:
  266.  
  267.                   fbuddy /bw
  268.  
  269.             Executing FileBUDDY for the first time will create an
  270.             initialization file called FBUDDY.INI.  (For more information
  271.             about this file, refer to the section on "Customizing
  272.             FileBUDDY".)
  273.  
  274.  
  275.             Using FileBUDDY
  276.             ===============
  277.  
  278.             There are a couple of ways to load a file in FileBUDDY.  The
  279.             first method is to type the file name on the command line:
  280.  
  281.                   fbuddy filename
  282.  
  283.             The second method is to run FileBUDDY by itself:
  284.  
  285.                   fbuddy
  286.  
  287.             In the latter method, files are selected from a menu list.  To
  288.             scroll through the list, press the left mouse button and move the
  289.             mouse cursor past the top or bottom of the menu list.  If you
  290.             prefer to use the keyboard, the ARROW, HOME, END, PGDN, and PGUP
  291.             keys are supported.  Files are shown in lower case and
  292.             subdirectories in upper case.  Select ".." to change to the
  293.             parent directory.  Press ENTER or double click with the mouse to
  294.             select the file to view.
  295.  
  296.             Assuming a text file was selected, one can navigate through it
  297.             using the mouse or keyboard.  To scroll with the mouse, press the
  298.             left button and move the mouse in the direction you want to
  299.             scroll.  Clicking on the border around the text lets you to
  300.             scroll vertically a line at a time or horizontally a character at
  301.             a time.  Additionally, the following keys are recognized:
  302.  
  303.                   HOME              Positions the view window at column 1.
  304.  
  305.                   END               Positions the view window at the end
  306.                                     of the longest line in the current
  307.                                     view window.
  308.  
  309.                   CTRL+HOME          Positions the view window at the 
  310.                                      beginning of the file.
  311.  
  312.                   CTRL+END           Positions the view window at the end
  313.                                      of the file.
  314.  
  315.                   CTRL+LEFT ARROW    Pages the view window to the left.
  316.  
  317.  
  318.  
  319.  
  320.                                                                             3
  321.                   CTRL+RIGHT ARROW   Pages the view window to the right.
  322.  
  323.                   PGUP               Pages the view window up.
  324.  
  325.                   PGDN               Pages the view window down.
  326.  
  327.                   UP ARROW           Scrolls the view window up one line.
  328.  
  329.                   DOWN ARROW         Scrolls the view window down one line.
  330.  
  331.                   LEFT ARROW         Scrolls the view window one character
  332.                                      to the left.
  333.  
  334.                   RIGHT ARROW        Scrolls the view window one character
  335.                                      to the right.
  336.  
  337.  
  338.             Menus And Messages
  339.             ==================
  340.  
  341.             Menus and messages are all displayed at the bottom of the screen.
  342.             There are three menus in FileBUDDY: the View Menu, the Main Menu,
  343.             and the Setup Menu.  The following is a breakdown of commands
  344.             under each menu:
  345.  
  346.                   Located in the View Menu:
  347.  
  348.                   [M]ain             Selects the Main Menu.  (Pressing the
  349.                                      right mouse button does the same thing.)
  350.  
  351.                   Located in the Main Menu:
  352.  
  353.                   [O]pen             Displays the file directory to open a
  354.                                      file for viewing.  (Pressing ESC from
  355.                                      the View Menu does the same thing.)
  356.  
  357.                   [E]dit             Edits the file you are viewing.
  358.  
  359.                   [F]ind             Searches for a word or phrase in the 
  360.                                      file.
  361.  
  362.                   [N]ext             Continues searching from last "Find".
  363.  
  364.                   [C]apture          Toggles capture mode "on or off".
  365.  
  366.                   [U]nArc            Extracts the archived file currently 
  367.                                      being viewed.
  368.  
  369.                   [P]rint            Prints the file you're viewing.
  370.              
  371.                   [S]etup            Selects the Setup Menu.
  372.  
  373.  
  374.  
  375.  
  376.  
  377.                                                                             4
  378.                   [Q]uit             Exits FileBUDDY.  (Pressing ESC twice
  379.                                      from the View Menu does the same thing.
  380.                                      If you are viewing an archived file you
  381.                                      will have to press ESC three times.)
  382.  
  383.                   Located in the Setup Menu:
  384.  
  385.                   Confi[G]Prn        Displays the printer configuration
  386.                                      list.
  387.  
  388.                   SetConfig[D]efault Assigns a configuration name of
  389.                                      your choice to DEFAULT.
  390.  
  391.             All commands in each menu can be accessed three ways:
  392.  
  393.                   1) pressing the command's highlighted letter
  394.                   2) clicking over the command name with the mouse
  395.                   3) pressing CTRL+[highlighted letter]
  396.  
  397.  
  398.             Editing A File
  399.             ==============
  400.  
  401.             Text files may be edited using CTRL+E.  FileBUDDY does not have
  402.             an editor so one must be defined in FBUDDY.INI.  (Refer to the
  403.             'Editor' parameter description in "Customizing FileBUDDY" for
  404.             more information).  When attempting to edit a very large file,
  405.             remember that your editor may not be able to edit the file.  The
  406.             reason for this is because FileBUDDY has no limit on the size of
  407.             file it can view and your text editor probably does.  No harm is
  408.             done if you try to edit such a file as the editor will just abort
  409.             and return you to FileBUDDY.
  410.  
  411.             Note that archived text files may also be edited.  Edit them like
  412.             you would a normal file.  If the file is modified, FileBUDDY will
  413.             prompt you if you want to update the archive file.  If so, press
  414.             "Y" or "y" or the ENTER key.  If not, press the ESC key (or any
  415.             other key).
  416.  
  417.  
  418.             Searching Text
  419.             ==============
  420.  
  421.             Using the Find command CTRL+F, you can search for any character,
  422.             word, or phase in a file. FileBUDDY starts its search from the
  423.             first line at the top of the screen.  Searches are case
  424.             insensitive.  If an occurrence of the text is found, it'll be
  425.             highlighted.  To continue the search, press CTRL+N.  You can
  426.             enter new search criteria by pressing CTRL+F again.  The
  427.             contents of the previous search may be cleared with SHIFT+DELETE.
  428.             (Pressing the SHIFT+INSERT keys restores them.)
  429.  
  430.  
  431.  
  432.  
  433.  
  434.                                                                             5
  435.             Capturing Text
  436.             ==============
  437.  
  438.             Capture mode is invoked with CTRL+C.  FileBUDDY will prompt you
  439.             for the name of the destination file for the text to be saved to.
  440.             The default file name is FBUDDY.CAP with the path being what was
  441.             specified in FBUDDY.INI under 'WorkDir'.  If you want to modify
  442.             this, press SHIFT+DELETE to clear the contents of field and enter
  443.             the new destination file.  (As was mentioned earlier, use the
  444.             SHIFT+INSERT keys to restore the contents.)  When text is saved
  445.             to a capture file, it will always be appended.
  446.  
  447.             Snapshots are taken with the ENTER key.  A large block of text
  448.             can be captured using the PGDN and ENTER keys alternately.  If
  449.             you prefer to scroll using the mouse or arrow keys, don't worry
  450.             about overlapping text between consecutive snapshots as it will
  451.             not be duplicated in the capture file.  Snapshots not
  452.             consecutively taken are separated by a solid bar line.
  453.  
  454.             Capture mode is turned off by pressing CTRL+C again.  It's not
  455.             necessary to turn Capture mode off before exiting FileBUDDY
  456.             because this is done automatically.
  457.  
  458.  
  459.             Extracting An Archived File
  460.             ===========================
  461.  
  462.             If you are viewing an archived file and would like to extract
  463.             ("un-arc") it to a work directory of your choice, press CTRL+U.
  464.             The default work directory will be what you specified under
  465.             'WorkDir' in FBUDDY.INI.
  466.  
  467.  
  468.             Configuring Your Printer
  469.             ========================
  470.  
  471.             Before printing a file, you'll need to configure your printer.
  472.             Press CTRL+G and select the desired configuration from the menu
  473.             list.  (If you are just starting out, the only names you will see
  474.             are DEFAULT and NOSETUP.)
  475.  
  476.             The configuration name called DEFAULT always appears at the top
  477.             of the menu list and is used to store a printer configuration
  478.             that you want FileBUDDY to automatically use (if the printer is
  479.             not already configured) when printing.  (You can also use it
  480.             yourself as a regular configuration name.)  To assign DEFAULT to
  481.             a configuration, press CTRL+D from the Setup menu.
  482.  
  483.             NOSETUP is a 'blank' setup for FileBUDDY to use when printing
  484.             text files.  When FBUDDY.INI is created, FileBUDDY assigns the
  485.             NOSETUP configuration to DEFAULT.  Because NOSETUP contains no
  486.             setup codes, your printer is not configured in any way.  To
  487.  
  488.  
  489.  
  490.  
  491.                                                                             6
  492.             create your own configurations, refer the section on "Creating
  493.             Printer Configurations".
  494.  
  495.             If you attempt to configure your printer while it is off-line, an
  496.             error message will occur after a pre-determined amount of printer
  497.             "checks".  Depending on the speed of your machine, this will
  498.             translate into a pause of anywhere from 72 seconds for a XT to
  499.             less than 25 seconds for a  386 compatible.  No delay will occur
  500.             if the printer is turned off, however.
  501.  
  502.  
  503.             Creating Printer Configurations
  504.             ===============================
  505.  
  506.             All printer configurations you create will be stored in the
  507.             FBUDDY.INI file.   To create printer configurations, use your
  508.             text editor or word processor.  Remember to resave FBUDDY.INI in
  509.             ASCII format any time it is modified.  Most text editors will do
  510.             this but if you are using a word processor this will not
  511.             necessarily be true.  Consult your word processor manual on how
  512.             to save to ASCII.
  513.  
  514.             Each configuration is distinguished by a unique name and preceded
  515.             by the "@" character.  When creating a name, any combination of
  516.             upper or lower case letters may be used.  The name should be no
  517.             longer than 12 characters in length.  For example:
  518.  
  519.                   @CONDENSED
  520.  
  521.             To setup a printer connected to LPT2 or LPT3, insert a colon
  522.             after the name and type "LPT2" or "LPT3" like:
  523.  
  524.                   @CONDENSED:LPT2
  525.  
  526.             For each printer command line, type some descriptive text of any
  527.             length and follow it with the "=" character.  Place the
  528.             appropriate control codes after the "=" character, separating
  529.             each value with a comma.  (A list of printer commands and
  530.             formatting codes for your printer can normally be found under a
  531.             section called "Command Reference" or "Command Summary" in the
  532.             printer's reference manual.)  FileBUDDY recognizes printer codes
  533.             in decimal or hexadecimal format.  Make sure if you use
  534.             hexadecimal codes that you precede each value with "&H".   Here
  535.             are some examples:
  536.  
  537.                   @CONDENSED:LPT2
  538.                   Master Reset  =27,64
  539.                   Condensed ON  =15
  540.                   Left Margin=   &H1B,&H6C,&H07
  541.                   Right Margin   27,81,127
  542.  
  543.             Note how spaces (or Tabs) may be inserted between the text and
  544.             "=" or between "=" and the first control code value for alignment
  545.             purposes.  If you need to temporarily prevent a line from being
  546.  
  547.  
  548.                                                                             7
  549.             processed, leave out the "=" as shown in the last line.  (It may
  550.             be more convenient to duplicate the configuration under a
  551.             different name without that line.)
  552.  
  553.             Keep things easy to read by using a blank line between
  554.             configurations.  Below is a copy of SAMPLE.INI showing what a
  555.             typical FBUDDY.INI file may look like:
  556.  
  557.                   [INITIALIZATION]
  558.                   MouseSen=12
  559.                   MouseSS=12
  560.                   MouseLBSS=60
  561.                   FileSort=2
  562.                   PrnConfigSort=1
  563.                   BeepSound=6
  564.                   Shadow=1
  565.                   Border=1
  566.                   LBBorder=3
  567.                   HelpBorder=2
  568.                   TextColor=7
  569.                   LBTextColor=7
  570.                   BorderColor=14
  571.                   LBBorderColor=14
  572.                   HelpTextColor=7
  573.                   HelpBorderColor=10
  574.                   HMBarColor=27
  575.                   HiLiteColor=30
  576.                   FilenameColor=31
  577.                   LBCsrColor=48
  578.                   MouseCsrColor=71
  579.  
  580.                   [PATHS]
  581.                   WorkDir=c:\workdir
  582.                   Editor=c:\dos\edit.com
  583.                   ARC=c:\utils\arc.exe
  584.                   ARJ=c:\utils\arj.exe
  585.                   LZH=c:\utils\lha.exe
  586.                   PAK=c:\utils\pak.exe
  587.                   ZIP=c:\utils\pkunzip.exe
  588.  
  589.                   [IMAGE]
  590.                   VRam1024=0
  591.                   ImageLPT=1
  592.                   ImageDPT=300
  593.                   ImageSize=8
  594.                   ImageRow=0
  595.                   ImageColumn=100
  596.                   ImagePrtMode=0
  597.                   ImageOrient=0
  598.                   ImageBorder=0
  599.  
  600.                   [PRINTER]
  601.                   PrnSetupDefault=NLQ
  602.  
  603.  
  604.  
  605.                                                                             8
  606.                   @NOSETUP
  607.  
  608.                   @NLQ
  609.                   Master Reset   =27,64
  610.                   Select NLQ     =27,120,1
  611.                   Roman Font     =27,107,0
  612.                   Left Margin    =27,108,5
  613.                   Bottom Margin  =27,78,7
  614.  
  615.                   @CONDENSED:LPT2
  616.                   Master Reset   =27,64
  617.                   Condensed ON   =15
  618.                   Left Margin    =27,108,7
  619.                   Right Margin   =27,81,127
  620.                   Bottom Margin  =27,78,7
  621.                   Tab Increments =27,101,0,2
  622.  
  623.                   @GRAPHICS:LPT3
  624.                   Master Reset   =27,64
  625.                   Graphic Mode   =27,116,1,27,6
  626.                   Left Margin    =27,108,5
  627.  
  628.             Notice how each example starts with a "Master Reset".  This
  629.             clears any previous settings in the printer to the setting set by
  630.             its "dip switches".  (This is the same thing as turning your
  631.             printer off and then back on again.)  Keep in mind reset codes
  632.             vary from printer to printer so the ones used in the examples may
  633.             or may not apply to you.
  634.  
  635.  
  636.             Viewing, Saving, And Printing Images
  637.             ====================================
  638.  
  639.             Because there are so many SVGA video cards on the market, it is
  640.             impossible to support them all.  If your video card is not
  641.             designed around the ATI, Paradise, Trident, Tseng, or Video 7
  642.             chipset, check for VESA compatibility.  If your video card's
  643.             hardware isn't VESA compatible, look for VESA compatibility in
  644.             the form of a driver (TSR) on the disks that came with your video
  645.             card.  The driver allows FileBUDDY to select the video card's
  646.             extended modes when displaying images larger than 320x200x256.
  647.             If you are unsuccessful in locating the VESA driver, check with
  648.             the video card manufacturer (or call their BBS if they operate
  649.             one).  Chances are one is available.  Nevertheless, FileBUDDY
  650.             can display any image file size in the standard VGA mode of
  651.             320x200x256.  But keep in mind that you still need to have enough
  652.             memory to hold the complete image.  Also, the larger the image,
  653.             the greater the amount of image loss will result when it is
  654.             displayed.
  655.  
  656.             If your SVGA card has 1MB of memory, set the VRam1024 parameter
  657.             (in FBUDDY.INI) to 1.  This tells FileBUDDY to use the
  658.             1024x768x256 mode to display image files larger than 800x600x256.
  659.             If the video card is equipped with only 512KB of memory (VRam1024
  660.  
  661.  
  662.                                                                             9
  663.             should be set to 0), images larger than 800x600x256 will be
  664.             resized and displayed at 800x600x256.
  665.  
  666.             Before loading an image, FileBUDDY checks for expanded memory
  667.             (EMS) or extended memory (XMS), in that order.  If found, it will
  668.             be used to hold the image.  If not, the image will be loaded into
  669.             conventional memory (memory permitting).
  670.  
  671.             When images are displayed, FileBUDDY displays them in their
  672.             proper aspect ratio.  Therefore, images may not always completely
  673.             fill the video screen.  You can resize the images to use the
  674.             whole video screen by pressing the TAB key.
  675.  
  676.             Since FileBUDDY supports more than one image format, you have the
  677.             option of saving images across to the other formats.  To do so,
  678.             use the following function keys:
  679.  
  680.                   F4      Save as BIF (binary format)
  681.                   F5      Save as GIF
  682.                   F6      Save as PCX
  683.                   F7      Save as EPS (Encapsulated PostScript)
  684.                   F8      Save as TIF (uncompressed)
  685.                   F9      Save as TIF (LZW compression)
  686.                   F10     Save as TIF (PackBits compression)
  687.  
  688.             When saving an image, you'll be asked to enter the new image's
  689.             dimensions (like 320x200, 640x480, 1024x768, or whatever).  Press
  690.             ENTER to use the source image's dimensions.  The default location
  691.             where the image will be saved is defined by the 'WorkDir'
  692.             parameter in FBUDDY.INI.  The default image name will be the same
  693.             as the source image but with appropriate extension.
  694.  
  695.             When loading a BIF (binary) image, unlike the other image
  696.             formats, you'll be asked for its dimensions.  This is because the
  697.             format does not save any information about the image.  The
  698.             default is set at 320x200.  You may have to experiment with
  699.             different sizes until you find the right size to capture the
  700.             complete image.
  701.  
  702.             If a HP LaserJet or compatible laser printer is available, images
  703.             can be printed using CTRL+P.  FileBUDDY will need to know three
  704.             things:
  705.  
  706.                   1)  Overall Brightness Level
  707.                   2)  Intermediate Brightness Level
  708.                   3)  Image Dimensions
  709.  
  710.             Overall Brightness Level values range from -255 to 255, where 0
  711.             is no adjustment.  Intermediate Brightness Level values range
  712.             from 0 to 9, where 0 is also equal to no adjustment.  When
  713.             printing an image for the first time, press ENTER to all three
  714.             prompts.  If you find the image printed too "washed out", set the
  715.             Intermediate Brightness Level to 0 and print the image again.
  716.  
  717.  
  718.  
  719.                                                                             10
  720.             If the image now prints too dark, increase the Overall Brightness
  721.             Level.  (You may have to increment it in multiples of 10 to see
  722.             any change in the printed image.)  If you need more control over
  723.             the 'exposure' of the image, you may want to experiment with both
  724.             brightness types.
  725.  
  726.             Sometimes the printed image's aspect ratio may not look the same
  727.             as the image on the screen.  This is not an error in FileBUDDY.
  728.             What's happening is when the image completely fills the video
  729.             screen, the monitor's aspect ratio changes the image's apparent
  730.             aspect ratio.  This is especially noticeable when printing an
  731.             image of a human face.  To compensate for this "distortion",
  732.             increase the length of the image slightly.  For example, if
  733.             the image's dimensions are 320x200, change it to 320x225.
  734.  
  735.             If you want a border drawn around the printed image, set
  736.             'ImageBorder' in FBUDDY.INI to 2.  For more information about it
  737.             and other image parameters, refer to the section "Customizing
  738.             FileBUDDY" under the [IMAGE] heading.
  739.  
  740.             If you do not have a HP compatible printer, you can print the
  741.             image to a file using CTRL+F.  The file can then be printed from
  742.             the command line on another computer connected to a HP or
  743.             compatible laser printer using:
  744.  
  745.                   copy imagename.prt lpt1:/b
  746.  
  747.             If the laser printer is connected to "lpt2" or "lpt3", substitute
  748.             accordingly.  Make sure you use the "/b" switch to ensure the
  749.             whole file is printed. However way you choose to print images, be
  750.             patient.  This is especially true with large images or when
  751.             enlarging images.
  752.  
  753.  
  754.             To load another image file, press ESC to display the file
  755.             directory.  To quit viewing the current image, press ESC twice.
  756.  
  757.  
  758.             Customizing FileBUDDY
  759.             =====================
  760.  
  761.             FileBUDDY stores "modifiable" parameters in FUBDDY.INI.  Since
  762.             the file is as an ASCII file, you can easily customize it with
  763.             any text editor.  Below is a description of each parameter:
  764.  
  765.                   [INITIALIZATION]  The parameters under this heading are
  766.                                     required for FileBUDDY to run properly.
  767.                                     Make sure that you do not delete them.
  768.  
  769.                   MouseSen          Sets the mouse sensitivity.  Useful 
  770.                                     values are between 0 and 100.
  771.  
  772.                   MouseSS           Sets the mouse scroll speed.
  773.  
  774.  
  775.  
  776.                                                                             11
  777.                   MouseLBSS         Sets the mouse scroll speed for list
  778.                                     boxes (ie. file and archive directory).
  779.                                     Use values from 0 and up.
  780.  
  781.                   FileSort          Determines how file names will be sorted.
  782.                                     0=don't sort, 1=sort by name, 2=sort by 
  783.                                     extension
  784.  
  785.                   PrnConfigSort     Determines whether the printer 
  786.                                     configuration names will be sorted.
  787.                                     0=don't sort, 1=sort
  788.  
  789.                   BeepSound         Sets the type of "beep sound" for error
  790.                                     messages.  Values range from 0 to 10.
  791.                                     0=no sound.
  792.  
  793.                   Shadow            Determines whether a shadow will be
  794.                                     projected when a list box is displayed.
  795.                                     0=no shadow, 1=shadow
  796.  
  797.                   Border            Sets the main borders in the program.
  798.                                     There are four types to choose from:
  799.  
  800.                                     1 = Single line all around
  801.                                     2 = Double line all around
  802.                                     3 = Double line horizontally, single
  803.                                         line vertically
  804.                                     4 = Single line horizontally, double
  805.                                         line vertically
  806.  
  807.                   LBBorder          Sets the list box border type.  There are
  808.                                     four types to choose from.  (See Border
  809.                                     parameter for list.)
  810.  
  811.                   HelpBorder        Sets the Help box border type.  There are
  812.                                     four types to choose from.  (See Border
  813.                                     parameter for list.)
  814.  
  815.                   TextColor         Sets the main text color.
  816.  
  817.                   LBTextColor       Sets the list box text color.
  818.  
  819.                   BorderColor       Sets the main border color.
  820.  
  821.                   LBBorderColor     Sets the list box border color.
  822.  
  823.                   HelpTextColor     Sets the Help text color.
  824.  
  825.                   HelpBorderColor   Sets the Help list box border color.
  826.  
  827.                   HMBarColor        Sets the text color for the menus and
  828.                                     messages.
  829.  
  830.  
  831.  
  832.  
  833.                                                                             12
  834.                   HiLiteColor       Sets the highlight text color.
  835.  
  836.                   FilenameColor     Sets the file name text color.
  837.  
  838.                   LBCsrColor        Sets the list box cursor color.
  839.  
  840.                   MouseCsrColor     Sets the mouse cursor color.  (This
  841.                                     parameter will be set to -1 if FileBUDDY
  842.                                     is configured for "black & white".)
  843.  
  844.                   [PATHS]           Parameters under this heading allow you
  845.                                     specify the name and location of the
  846.                                     associated programs.  You MUST add the
  847.                                     PATH and EXTENSION of each program or
  848.                                     they will not be located, even if they
  849.                                     are your PATH statement.
  850.  
  851.                                     The following are the achivers FileBUDDY
  852.                                     recognizes:
  853.              
  854.                                          ARC v6.00
  855.                                          ARCE v3.1, 4.0g
  856.                                          ARJ v2.10-2.30
  857.                                          LHA v2.11-2.13
  858.                                          PAK v2.51
  859.                                          PKUNZIP v1.10
  860.  
  861.                                     Previous or future versions of the
  862.                                     archivers may or may not work.  All you
  863.                                     can do is try and see.
  864.  
  865.                   WorkDir           Specifies your default work directory
  866.                                     path.
  867.  
  868.                   Editor            This parameter allows you to specify
  869.                                     the text editor or word processor of your
  870.                                     choice.  Assuming your editor is called
  871.                                     "edit.com" and located in c:\dos, you
  872.                                     would set it up as:
  873.  
  874.                                          Editor=c:\dos\edit.com
  875.  
  876.                   ARC               This parameter recognizes three different
  877.                                     archivers.  They are ARC.EXE by SEA,
  878.                                     ARCE.COM by Wayne Chin/Vernon D. Buerg
  879.                                     and PAK.EXE by NoGate Consulting.  Below
  880.                                     are examples to set each up:
  881.  
  882.                                     - Assuming you want to use ARC to view
  883.                                     "ARCs" and the archiver is located in
  884.                                     c:\utils\arc, set it up as:
  885.  
  886.                                          ARC=c:\utils\arc\arc.exe
  887.  
  888.  
  889.  
  890.                                                                             13
  891.                                     - Assuming you want to use ARCE to view
  892.                                     "ARCs" and the archiver is located in
  893.                                     c:\utils\arc, set it up as:
  894.  
  895.                                          ARC=c:\utils\arc\arce.com
  896.  
  897.                                     - Assuming you want to use PAK to view
  898.                                     "ARCs" and the archiver is located in
  899.                                     c:\utils\pak, set it up as:
  900.  
  901.                                          ARC=c:\utils\pak\pak.exe
  902.  
  903.                   ARJ               This parameter recognizes one archiver.
  904.                                     The archiver is called ARJ.EXE by Robert
  905.                                     K. Jung.  Assuming the archiver is
  906.                                     located in c:\utils\arj, set it up as:
  907.  
  908.  
  909.                                          ARJ=c:\utils\arj\arj.exe
  910.  
  911.                   LZH               This parameter recognizes one archiver.
  912.                                     The archiver is called LHA.EXE by
  913.                                     Haruyasu Yoshizaki.  Assuming the 
  914.                                     archiver is located in c:\utils\lha, set
  915.                                     it up as:
  916.  
  917.                                          LZH=c:\utils\lha\lha.exe
  918.  
  919.                   PAK               This parameter recognizes one archiver.
  920.                                     The archiver is called PAK.EXE by NoGate
  921.                                     Consulting.  Assuming the archiver is
  922.                                     located in c:\utils\pak, set it up as:
  923.  
  924.                                          PAK=c:\utils\pak\pak.exe
  925.  
  926.                   ZIP               This parameter recognizes two archivers.
  927.                                     They are PKUNZIP.EXE by PKWare and 
  928.                                     PAK.EXE by NoGate Consulting.  Below are
  929.                                     examples to set each up:
  930.  
  931.                                     - Assuming you want to use PKUNZIP to
  932.                                     view "ZIPs" and the archiver is located
  933.                                     in c:\utils\pkzip, set it up as:
  934.  
  935.                                          ZIP=c:\utils\pkzip\pkunzip.exe
  936.  
  937.                                     - Assuming you want to use PAK to view
  938.                                     "ZIPs" and the archiver is located in
  939.                                     c:\utils\pak, set it up as:
  940.  
  941.                                          ZIP=c:\utils\pak\pak.exe
  942.  
  943.  
  944.  
  945.  
  946.  
  947.                                                                             14
  948.                   [IMAGE]           This heading marks the location of the
  949.                                     image parameters.
  950.  
  951.                   VRam1024          If your video card has 1M (1024K) of
  952.                                     memory, set this to 1.  (1=1M available,
  953.                                     0=1M not available)  Video memory
  954.                                     information is normally found on the
  955.                                     first or second line of your display when
  956.                                     the computer is booting-up.
  957.  
  958.                   ImageLPT          Specifies the printer port where the HP
  959.                                     LaserJet (or compatible) printer is
  960.                                     Connected: 1=LPT1, 2=LPT2, 3=LPT3.
  961.  
  962.                   ImageDPI          Sets the resolution of the HP LaserJet
  963.                                     (or compatible) printer.  Valid printer
  964.                                     resolutions are: 75, 100, 150, and 300.
  965.  
  966.                   ImageSize         Sets the overall size of the image.  This
  967.                                     parameter actually defines the image's
  968.                                     width.  (The image's length is
  969.                                     automatically defined by the image's
  970.                                     aspect ratio.)  Use values greater than 
  971.                                     0.  A value of 1 is equivalent to 1" or
  972.                                     2.54 cm.  Printed images are
  973.                                     automatically limited to 2399 x 3149 in
  974.                                     size.  To calculate these limits,
  975.                                     multiply ImageSize by ImageDPI.
  976.  
  977.                   ImageRow          Sets the "row" coordinate where the image
  978.                                     will be printed on the paper.  Values are
  979.                                     with reference to the top upper left
  980.                                     corner of the paper oriented in the
  981.                                     vertical position (even when printing in 
  982.                                     landscape mode).  It is expressed in
  983.                                     1/300 inch.  A value of 300 would
  984.                                     therefore represent 1 inch or 2.54 cm.
  985.                                     Use values starting from 0.
  986.  
  987.                   ImageColumn       Sets the "column" coordinate where the
  988.                                     image will be printed on the paper.
  989.                                     Values are with reference to the top
  990.                                     upper left corner of the paper oriented
  991.                                     in the vertical position (even when
  992.                                     printing in landscape mode).  It is
  993.                                     expressed in 1/300 inch.  A value of 300
  994.                                     would therefore represent 1 inch or
  995.                                     2.54 cm.  Use values starting from 0.
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.                                                                             15
  1005.                   ImagePrtMode      Valid print modes are: 0=minimum average
  1006.                                     error technique, 1=halftone technique.
  1007.                                     The minimum average error technique
  1008.                                     also referred to as "error diffusion"
  1009.                                     normally produces a sharper and more
  1010.                                     detailed picture but takes 20% longer to
  1011.                                     print.  This mode is well suited for
  1012.                                     offset printing.  If you plan to
  1013.                                     photocopy the image, use mode 1 (halftone
  1014.                                     technique).
  1015.  
  1016.                   ImageOrient       Sets the image orientation: 0=portrait
  1017.                                     (vertical), 1=landscape(horizontal).
  1018.                                     Landscape mode is memory dependent.
  1019.                                     Therefore, if insufficient memory is
  1020.                                     detected, the image will be printed in
  1021.                                     portrait mode.
  1022.  
  1023.                   ImageBorder       Determines the thickness of the border
  1024.                                     around the image in 1/300 inch
  1025.                                     increments.  A "2" for example represents
  1026.                                     a "2-dot-border".  The higher the number
  1027.                                     the thicker the border.  0=no border
  1028.  
  1029.                   [Printer]         This heading marks the location where
  1030.                                     printer configurations are stored.  Refer
  1031.                                     "Creating Printer Configurations" for
  1032.                                     help on creating your own.
  1033.  
  1034.                   PrnSetupDefault   Stores a default printer configuration
  1035.                                     name.  It's normally defined within
  1036.                                     FileBUDDY from the Setup Menu with
  1037.                                     SetConfigDefault.  Make sure this
  1038.                                     parameter precedes all printer
  1039.                                     configurations.
  1040.  
  1041.                   The rest of the FBUDDY.INI file is used to store your
  1042.                   printer configurations.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                                                                             16
  1062.             Questions
  1063.             =========
  1064.  
  1065.             Well, that's about it.  If you have any problems, questions, or
  1066.             suggestions regarding FileBUDDY, I would like to hear from you.
  1067.             You can write to me at:
  1068.  
  1069.                   Lenard Dean
  1070.                   Box 73094, Woodbine Postal Outlet
  1071.                   Calgary, Alberta  T2W6E0
  1072.                   Canada
  1073.  
  1074.             You can also reach me through one of the following electronic
  1075.             services:
  1076.  
  1077.                   CompuServe ID: 70312,415
  1078.                        GEnie ID: L.DEAN1
  1079.  
  1080.             Happy viewing!
  1081.  
  1082.  
  1083.  
  1084.  
  1085.  
  1086.  
  1087.  
  1088.  
  1089.  
  1090.  
  1091.  
  1092.  
  1093.  
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.                                                                             17
  1119.             Appendix A
  1120.             ==========
  1121.  
  1122.  
  1123.             Registration
  1124.             ------------
  1125.  
  1126.             FileBUDDY is being distributed as SHAREWARE.  This method of
  1127.             distribution means that you may evaluate FileBUDDY for a
  1128.             reasonable period of time.  (I'll leave the "reasonable" part up
  1129.             to you.)  If you find that FileBUDDY meets your needs and you
  1130.             continue to use it, please license your copy by registering it.
  1131.             (See REGISTER.FRM in FB100.EXE)  If you are a commercial user,
  1132.             please contact me for liberal site license terms.
  1133.  
  1134.             The registration fee for using FileBUDDY is $15 US.  When you
  1135.             register, you will receive a printed manual and the latest
  1136.             version of FileBUDDY.  You will also be notified when major
  1137.             FileBUDDY upgrades are released.
  1138.  
  1139.             Money orders or personal, certified, and traveller's checks are
  1140.             accepted.  If you are paying by personal check, payment does not
  1141.             necessarily have to be in US funds.  Local currency is acceptable
  1142.             as long as the amount is equivalent to the amount in US dollars.
  1143.             Check with your bank for the current exchange rate for you to buy
  1144.             US dollars.  If you are ordering outside North America, please
  1145.             don't forget to add the additional $2.00 US for shipping (even if
  1146.             it's being sent by registered mail).
  1147.  
  1148.             Thankyou for your support.
  1149.  
  1150.  
  1151.  
  1152.  
  1153.  
  1154.  
  1155.  
  1156.  
  1157.  
  1158.  
  1159.  
  1160.  
  1161.  
  1162.  
  1163.  
  1164.  
  1165.  
  1166.  
  1167.  
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.  
  1174.  
  1175.                                                                             18
  1176.             APPENDIX B
  1177.             ==========
  1178.  
  1179.  
  1180.             Color Chart
  1181.             -----------
  1182.  
  1183.  
  1184.                                              BACKGROUND
  1185.  
  1186.                         Black  Blue  Green  Cyan  Red  Magenta  Brown  White
  1187.  
  1188.                Black       0    16     32    48    64     80      96    112
  1189.                Blue        1    17     33    49    65     81      97    113
  1190.                Green       2    18     34    50    66     82      98    114
  1191.             F  Cyan        3    19     35    51    67     83      99    115
  1192.             O  Red         4    20     36    52    68     84     100    116
  1193.             R  Magenta     5    21     37    53    69     85     101    117
  1194.             E  Brown       6    22     38    54    70     86     102    118
  1195.             G  White       7    23     39    55    71     87     103    119
  1196.             R  Grey        8    24     40    56    72     88     104    120
  1197.             O  BrBlue      9    25     41    57    73     89     105    121
  1198.             U  BrGreen    10    26     42    58    74     90     106    122
  1199.             N  BrCyan     11    27     43    59    75     91     107    123
  1200.             D  BrRed      12    28     44    60    76     92     108    124
  1201.                BrMagenta  13    29     45    61    77     93     109    125
  1202.                Yellow     14    30     46    62    78     94     110    126
  1203.                BrWhite    15    31     47    63    79     95     111    127
  1204.  
  1205.  
  1206.  
  1207.  
  1208.  
  1209.  
  1210.  
  1211.  
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.                                                                             19 
  1233.